home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 002 / flistdh3.arj / FLISTTDH.DOC < prev    next >
Text File  |  1995-02-14  |  8KB  |  377 lines
  1.  
  2.                                 FLISTTDH.EXE
  3.  
  4.                          Copyright 1995 Colin Birch
  5.  
  6.                        The Dog House BBS 01443 400327
  7.  
  8.                        24 Hours - 2400 to 28800 VFast
  9.  
  10.                              FIDONET 2:442/618
  11.  
  12.  
  13. What is FLISTTDH.EXE?
  14. ~~~~~~~~~~~~~~~~~~~~~
  15.  
  16.  FLISTTDH.EXE is an ~allfiles~ and ~newfiles~ creator for RemoteAccess 2.xx
  17. BBS's. It creates the files, archives them and copies them to the destination
  18. dirctories. It is extremely user configurable.
  19.  
  20.  
  21. How to Configure FLISTTDH
  22. ~~~~~~~~~~~~~~~~~~~~~~~~~
  23.   You must edit the file FLISTTDH.CTL to configure the program. A sample .CTL
  24.   file should be included in the archive with this program.
  25.  
  26.   A sample .CTL file is shown below :-
  27.  
  28.  
  29.  
  30. ;
  31. ;  Name for output file for all files list
  32. ;
  33.  
  34. ALLFILES allfiles.txt
  35.  
  36. This is the name the list of all files will be saved with
  37.  
  38.  
  39.  
  40.  
  41. ;
  42. ;  Name for output file for new files list
  43. ;
  44.  
  45. NEWFILES newfiles.txt
  46.  
  47. This is the name the list of new files will be saved with
  48.  
  49.  
  50.  
  51. ;
  52. ;  Name for MAIN header text - text displayed at start of all and new files
  53. ;  list.
  54. ;
  55.  
  56. MAINHEADER header.txt
  57.  
  58. This is the name of the asci text file which will be displayed at the start
  59. of file lists
  60.  
  61.  
  62. ;
  63. ;  Name of file displayed at END of all files list
  64. ;
  65.  
  66. MAINFOOTER footer.txt
  67.  
  68. This is the name of the asci text file which will be displayed at the end
  69. of file lists
  70.  
  71. 2 macros can be included in the text file
  72.  
  73. @ALLFILES  - Displays the total number of files available
  74. @ALLK      - Displays the total number of Kb
  75.  
  76.  
  77.  
  78. ;
  79. ;  Name of file displayed at start of EACH file area
  80. ;
  81.  
  82. AREAHEADER aheader.txt
  83.  
  84. This is the name of the asci text file which will be displayed at the start
  85. of each file area
  86.  
  87. 3 macros can be included in the text file
  88.  
  89.  
  90. @NAME      -  Name of area
  91. @NUM       -  Area number
  92. @DATE      -  The date
  93.  
  94.  
  95.  
  96. ;
  97. ;  Name of file displayed at end of EACH file area
  98. ;
  99.  
  100. AREAFOOTER afooter.txt
  101.  
  102. This is the name of the asci text file which will be displayed at the end
  103. of each file area
  104.  
  105. 2 macros can be included in the text file
  106.  
  107. @NOFILES   -  Number of files in area
  108. @TOTALK    -  Number of Kb in area
  109.  
  110.  
  111. The file date in the header text can be displayed in eight diferent formats
  112. as below:-
  113.  
  114. ;
  115. ;  Date format for lists
  116. ;
  117. ;  1 -   DA-MO-YEAR  (01-02-1995)
  118. ;  2 -   DA-MO-YR    (01-02-95)
  119. ;  3 -   MO-DA-YEAR  (02-01-1995)
  120. ;  4 -   MO-DA-YR    (02-01-95)
  121. ;  5 -   DA-MON-YEAR (01-FEB-1995)
  122. ;  6 -   DA-MON-YR   (01-FEB-95)
  123. ;  7 -   MON-DA-YEAR (FEB-01-1995)
  124. ;  8 -   MON-DA-YR   (FEB-01-95)
  125.  
  126. DATEFORMAT 1
  127.  
  128.  
  129. The lowest RA file group to be included in the lists
  130.  
  131. ;
  132. ;  Minimum group number to be listed
  133. ;
  134.  
  135. MINGROUP 1
  136.  
  137.  
  138. The highest RA file group to be included in the lists
  139.  
  140. ;
  141. ;  Maximum group number to be listed
  142. ;
  143.  
  144. MAXGROUP 7
  145.  
  146.  
  147. The minimum RA list security to be included in the lists
  148.  
  149. ;
  150. ;  Minimum area security to be listed
  151. ;
  152.  
  153. MINSEC 0
  154.  
  155.  
  156. The maximum RA list security to be included in the lists
  157.  
  158. ;
  159. ;  Maximum area security to be listed
  160. ;
  161.  
  162. MAXSEC 100
  163.  
  164.  
  165. FDLISTTDH.EXE allows individual areas to be omitted from the files list. To
  166. omit an area just add the RA area number to the OMIT list. Up to ten areas
  167. may be omited.
  168.  
  169. ;
  170. ; Omit the following areas
  171. ; Syntax - OMITx (area number)
  172. ;        - OMIT1 2    - This would omit area 2 from the lists.
  173. ;        - OMIT4 231  - This would omit area 231 from the lists.
  174.  
  175. OMIT1 2
  176. OMIT2 15
  177. OMIT3 421
  178. OMIT4 231
  179. OMIT5
  180. OMIT6
  181. OMIT7
  182. OMIT8
  183. OMIT9
  184. OMIT10
  185.  
  186.  
  187. ;
  188. ;  Number of days old for files to be listed in new files list
  189. ;
  190.  
  191. DAYSOLD 10
  192.  
  193.  
  194. ;
  195. ;  Character to show file is new
  196. ;
  197.  
  198. NEWMARK *
  199.  
  200.  
  201. ;
  202. ;  Include a download counter in file description line ?
  203. ;
  204.  
  205. DOWNLOAD Y
  206.  
  207.  
  208. Automatically archive the lists using an archive type of your choice.
  209. Archive only operates in the REGISTERED version
  210.  
  211. ;
  212. ;  Archive file lists ?
  213. ;
  214.  
  215. ARCIT Y
  216.  
  217. Which archivers do we want to use - Registered only
  218. For the archive section to work, the archive software MUST be located
  219. on a DOS PATH. For more info. on PATHS please read your DOS manual.
  220.  
  221. ;
  222. ; Turn on individual archivers - 1 means use - 0 means don't use
  223. ;
  224.  
  225. ;  Use PKZIP
  226.  
  227. ARC(1) 1
  228.  
  229.  
  230. ;  Use ARJ
  231.  
  232. ARC(2) 1
  233.  
  234.  
  235. ;  Use LZH
  236.  
  237. ARC(3) 1
  238.  
  239.  
  240. ;  Use RAR
  241.  
  242. ARC(4) 0
  243.  
  244.  
  245. Path to copy files to when completed - 2 paths available - registered only
  246.  
  247.  
  248. ;
  249. ;  1st path to copy files to when completed
  250. ;
  251.  
  252. COPY1 F:\
  253.  
  254.  
  255. ;
  256. ;  2nd path to copy files to when completed leave blank if not used
  257. ;
  258.  
  259. COPY2
  260.  
  261. The following allows you to automatically delete the copies of the file list
  262. from the directory containing FLISTTDH.EXE once the files have been copied to
  263. the directories given above.
  264.  
  265.  
  266. ;
  267. ;  Delete work files once files have been copied to target directory?
  268. ;
  269.  
  270. DELORIG Y
  271.  
  272.  
  273. Post code used by registered key file
  274.  
  275. ;
  276. ;  Your Post Code (Zip code)
  277. ;
  278.  
  279. POSTCODE CF37 2AA
  280.  
  281.  
  282.  
  283. ;
  284. ;  Do you want a beep at the start and end of the program (registered users
  285. ;  only)
  286. ;
  287.  
  288. BEEP 1
  289.  
  290.  
  291. Running FLISTTDH.EXE
  292. ~~~~~~~~~~~~~~~~~~~~
  293.  
  294. To run FLISTTDH.EXE type FLISTTDH at the commans line. 
  295.  
  296. NOTE:- If, when you check your file listings, some of the descriptions do not
  297.        match the file names then use the command line FLISTTDH/COMPRESS
  298.        This runs RAFILE COMPRESS on the file descriptions before the filelists
  299.        are compiled. This is only normally needed if the file description file
  300.        has somehow become corrupted. Running /COMPRESS creates a file in the
  301.        FLISTTDH directory called COMP.FIL. This lists the RA areas that 
  302.        RAFILE COMPRESS will work with. This may be edited using a text editor
  303.        if needed. For more details on RAFILE COMPRESS please see your 
  304.        RemoteAccess Doc file.
  305.  
  306.  
  307.  
  308. What do I get if I register?
  309. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  310.   If you register your copy of FLISTTDH.EXE you will have the pause at the
  311.   beginning and end of the program removed. The ability to archive files
  312.   and to copy files will also be enabled.
  313.  
  314.  
  315. How to Register
  316. ~~~~~~~~~~~~~~~
  317.   To register file out the registration form and send with a cheque or postal
  318.   order made payable to C.Birch drawn on a British bank to :-
  319.  
  320.  
  321.    C.BIRCH (FLISTTDH)
  322.    21 Berw Road
  323.    PONTYPRIDD
  324.    Mid Glamorgan
  325.    CF37 2AA
  326.  
  327.  
  328. How much does it cost?
  329. ~~~~~~~~~~~~~~~~~~~~~~
  330.  
  331.   The registration fee for FLISTTDH.EXE is £10.00 if you are collecting your
  332.   registration ~key~ file via The Dog House BBS or £11.00 if you require
  333.   the ~key~ file to be sent to you.
  334.  
  335. NOTE - Registrations from OUTSIDE the UK are all PLUS £5-00 Sterling and MUST
  336.        be drawn on a UK bank.
  337.  
  338.  
  339.  
  340. Disclaimer
  341. ~~~~~~~~~~
  342.  
  343.  Although this software has been checked on various systems the only
  344.  guarantee I make is that it will take up hard disk space.
  345.  
  346.  
  347.  
  348. Shareware
  349. ~~~~~~~~~
  350.  
  351.   This program is released as Shareware. If, after a 21 day trial period, you
  352.   continue to use this program you MUST register it.
  353.  
  354.  
  355. Brief History
  356. ~~~~~~~~~~~~~
  357. To find the version number use the command FLISTTDH/V
  358.  
  359.  
  360.  V0.1b  - 1st beta test public release
  361.  
  362.  V0.2b  - 2nd beta test. File descriptions containing CHR$(13) should
  363.           nolonger have words split if description longer than 44 chars.
  364.  
  365.  V0.3b  - 3rd beta test. Program should now overwrite old file lists
  366.           Added Copying file to xxxxxx on file copy section.
  367.  
  368.  V0.4b  - 4th beta test. Added OMIT section and DELORIG section
  369.  
  370.  V1.0   - 1st non-beta release
  371.  
  372.  V1.1   - /COMPRESS option added. This is needed if your file description
  373.           files have become corrupted.
  374.  
  375.  V1.2   - Small bug in text input routine killed
  376.  
  377.